.TH std::setfill 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::setfill \- std::setfill

.SH Synopsis
   Defined in header <iomanip>
   template< class CharT >
   /*unspecified*/ setfill( CharT c );

   When used in an expression out << setfill(c) sets the fill character of the stream
   out to c.

.SH Parameters

   c - new value for the fill character

.SH Return value

   An object of unspecified type such that

     * if out is an object of type std::basic_ostream<CharT, Traits>, the expression
       out << setfill(c)
          * has type std::basic_ostream<CharT, Traits>&
          * has value out
          * behaves as if it called f(out, c)

   where the function f is defined as:

 template<class CharT, class Traits>
 void f(std::basic_ios<CharT, Traits>& str, CharT c)
 {
     // set fill character
     str.fill(c);
 }

.SH Notes

   The current fill character may be obtained with std::ostream::fill.

.SH Example


// Run this code

 #include <iomanip>
 #include <iostream>

 int main()
 {
     std::cout << "default fill: [" << std::setw(10) << 42 << "]\\n"
               << "setfill('*'): [" << std::setfill('*')
                                    << std::setw(10) << 42 << "]\\n";
 }

.SH Output:

 default fill: [        42]
 setfill('*'): [********42]

   Defect reports

   The following behavior-changing defect reports were applied retroactively to
   previously published C++ standards.

     DR    Applied to      Behavior as published         Correct behavior
   LWG 183 C++98      setbase could only be used with usable with any output
                      streams of type std::ostream    character stream

.SH See also

   fill     manages the fill character
            \fI(public member function of std::basic_ios<CharT,Traits>)\fP
   internal sets the placement of fill characters
   left     \fI(function)\fP
   right
   setw     changes the width of the next input/output field
            \fI(function)\fP
